home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Diamond Collection / The Diamond Collection (Software Vault)(Digital Impact).ISO / cdr05 / hookinf1.zip / VERONICA.TXT < prev   
Text File  |  1995-01-22  |  5KB  |  138 lines
  1.                   HOW TO COMPOSE VERONICA QUERIES
  2.  
  3.   The search understands the logical operators AND, NOT, OR, (, and ).
  4.   Adjacent keywords without an intervening logical operator are treated
  5.   as though conjoined by an AND.
  6.  
  7.   Interpretation of the query starts from the right-hand, interpreting
  8.   operators as encountered.
  9.   If in doubt about order of interpretation, USE PARENTHESES!
  10.  
  11.    Search keywords are NOT case-sensitive.
  12.  
  13.   ***  RESTRICTING  THE SEARCH TO CERTAIN GOPHER TYPES
  14.   You can limit the data returned by veronica to certain gopher item types.
  15.   This restriction is done by adding a -t type specifier to your query.
  16.   The -t flag may appear anywhere in the search specification.  For instance:
  17.    "women -t1"  returns links to gopher DIRECTORIES whose name contains "women".
  18.    "-t1 women"  does exactly the same thing.
  19.   NOTE that there must NOT be any spaces between the -t and the type specifier.
  20.  
  21.   You may specify MORE THAN ONE type in the query.  DO NOT use separate -t
  22.   specifications to do this; simply put all the types together (with no
  23.   spaces) after the -t.  For example:
  24.    "-ts1  mac"  returns links to gopher DIRECTORIES or SOUNDS with the word
  25.             "mac" in the name.
  26.    "women -t18"  returns links to gopher DIRECTORIES or TELNET links, whose 
  27.         name contains the word "women".
  28.  
  29.   Official gopher types, from the Gopher Protocol Document, are:
  30.  
  31.   0       item is a file
  32.   1       item is a directory
  33.   2       item is a CSO (qi) phonebook server
  34.   3       ERROR
  35.   4       item is a BinHexed Mac file (discouraged)
  36.   5       item is a DOS binary archive of some kind (discouraged)
  37.   6       item is a Unix uuencoded file (discouraged)
  38.   7       item is an Index-Search server
  39.   8       item is a pointer to a telnet session
  40.   9       item is a binary file of some sort
  41.   +       redundant server ( same a previous server )
  42.  
  43.   *** USING THE OPTIONS
  44.       Just include the options in the search query.  They will work
  45.       with any gopher client.  You can put options before the query words,
  46.       after the query words, or even between query words.
  47.  
  48.       DO NOT cluster more than one option behind a single hyphen; instead,
  49.       use a separate hyphen for each separate option.  For example:
  50.  
  51.         gopher -t1s -l -m400
  52.  
  53.      This example requests 400 items containing the word "gopher", and
  54.      specifies that we want only items whose type is "directory" or
  55.      "sound", and that we want a link-file containing the results.
  56.  
  57.   ***  EXAMPLES:
  58.  
  59.   Simple examples:
  60.  
  61.   Search on the keyword "internet".  This will return a menu list of
  62.   (at most) 200 records that have the word internet in the title field.
  63.       Just type-
  64.                       internet
  65.  
  66.   Search on the keyword "internet", but specify 1000 items instead of
  67.   the default 200.
  68.      type-
  69.                       internet -m1000
  70.         or
  71.                       -m1000 internet
  72.  
  73.   Search on the keywords "chicken" and "wine".  This returns a menu
  74.   list of (at most) 200 records that have _BOTH_ "chicken" and "wine".
  75.     Type-
  76.             chicken and wine
  77.  
  78.   Search for the keywords "chicken" or "wine", specifying directories only.
  79.   This returns a menu list of records that have _EITHER_ chicken or wine,
  80.   and which are GOPHER DIRECTORY entries.  Type-
  81.  
  82.             chicken or wine -t1
  83.     or
  84.             -t1 chicken or wine 
  85.  
  86.  
  87.   Examples for the operator "NOT":
  88.  
  89.   To use the operator "NOT" in a query:
  90.  
  91.  
  92.             chicken not wine    (will search for all titles with the 
  93.                                  word chicken _BUT NOT_ the word
  94.                                  wine)
  95.  
  96.             chinese food not msg     (will search for our health nuts
  97.                                      all the titles with the words
  98.                                      chinese _AND_ food _BUT NOT_
  99.                                      msg.  Remember there is an
  100.                                      implied _AND_ between two words)
  101.  
  102.     Examples for infix queries:
  103.  
  104.     The parentheses allow more complicated searches that were
  105.     not available in previous versions of the perl veronica server.
  106.  
  107.             examples:
  108.  
  109.             chicken (wine or curry)  -m      (will list ALL titles with the
  110.                                              words chicken _AND_ either
  111.                                              wine _OR_ curry.  -m asks
  112.                         for ALL records.)
  113.  
  114.             (chicken or wine) not (msg or growing)
  115.                                     (will search for titles with the
  116.                                      words chicken _OR_ wine _BUT NOT_
  117.                                      msg _OR_ growing)
  118.  
  119.     Examples for word stemming
  120.  
  121.     The metacharacter "*" matches anything at the TRAILING END of a 
  122.     search word.   
  123.  
  124.             chicken*            (will search for all titles with the
  125.                                  word chicken, chickens, ...)
  126.  
  127.             chicken* or wine*    (will search for all titles with the
  128.                                  word chicken, chickens, ... _OR_ 
  129.                                  wine, wines, wineries, ...)
  130.  
  131.             (chicke* or wine*) not (msg* or growing* and good*)
  132.                                 (this query results are left to the
  133.                                  curious)
  134.  
  135.  
  136.    Fred Barrie and Steve Foster
  137.  
  138.